home *** CD-ROM | disk | FTP | other *** search
/ AEMail 2.40 / AEMail v2.40.iso / arexx / addtogrp.readme < prev    next >
Text File  |  1998-09-25  |  4KB  |  82 lines
  1. Name: Addtogrp.aem
  2.  
  3. TO BE USED BY REGISTERED USER'S ONLY
  4.  
  5. This ARexx script is used to add To:  and cc:  names from a received
  6. message to a group entry in the Address Book.  This is particularly useful
  7. when there are multiple to:  and cc:  addresses.
  8.  
  9. NOTE: This script has been modified for AEMail 1.52 from prior released
  10. versions.  It uses the new ARexx command "GETLISTITEM" which was added to
  11. AEMail version 1.52 to display a list of groups.
  12.  
  13.                              HOW TO IMPLEMENT
  14.                              ----------------
  15.  
  16. This script is probably best placed in your REXX: directory.  If you wish
  17. to modify this script please note the following items:
  18.  
  19.     "name1" is used as a variable instead of "name".  If "name" were used
  20.         the AEMail ARexx command "NEXT NAME" would not execute properly
  21.         since NAME would be interpreted as the "name" variable.
  22.  
  23.     Note the use of "'" surrounding the name1 variable.  This will pass the
  24.         single quote to AEMail surrounding the name extracted from the To:
  25.         or "cc:" string.  AEMail will strip the single quote preserving any
  26.         double quotes which might surround the name.  If you were to use
  27.         '"' instead of "'", the proper action would not occur.
  28.  
  29.  
  30.                                 HOW TO USE
  31.                                 ----------
  32.  
  33.  
  34. Before you start the script you will need to display (or select) the
  35. message that has the multiple To:  or cc:  addresses.  If a message is not
  36. selected you will get an error that says "No message is selected".
  37.  
  38. When the script is called you will be prompted for a group nickname.  A 
  39. listview will be displayed that asks you to "Select the Group Wanted".  All 
  40. the groups in your Address Book will be displayed.  You can click on the 
  41. group you want to add the address to.  It will appear in the string gadget 
  42. below the list view.  Click on [OK] or press RETURN to accept this group.
  43.  
  44. If you want to create a new group, you can modify the nickname in the
  45. string gadget and the description name.  After ckicking on [OK] you will be
  46. asked if you want to create it, enter a new name, or cancel.  If you wish
  47. to create it, the group will be created when the first email address is
  48. processed.  You will be immediately prompted, however, for the Group
  49. Description (it will default to the description you entered in the list
  50. view string gadget) and if you want to set the Send Header Only flag when
  51. the group is created.  If you want quotes surrounding the group
  52. description, they should be entered with the group description string.
  53.  
  54. If the nickname is already used for an individual, you will be given an
  55. opportunity to reentering the nickname or cancelling.
  56.  
  57. If you cancel the "Select the Group Wanted" requester or one of the error
  58. notifications, you will exit from the script and will have to restart it.
  59.  
  60. You will always add the To: string to the Address Book.  After all of the
  61. To: addresses are added and if there is no cc: addresses the following
  62. message will be displayed:
  63.  
  64.     Last To: Name added - no cc: names
  65.  
  66. and the script will end after clicking on "CONTINUE"..
  67.  
  68. If there is a cc: address string you will see the following message
  69. displayed?
  70.  
  71.     Do you want to add cc: names?
  72.  
  73. You will be given a choice of YES or NO.  Clicking on NO will terminate the
  74. script.
  75.  
  76. Clicking on YES will add the cc: names to the Address Book.  After the last
  77. cc: address is added the following message will be displayed:
  78.  
  79.     Last CC: Name added
  80.  
  81. and the script will end after clicking on "CONTINUE".
  82.